home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Almathera Ten Pack 3: CDPD 3
/
Almathera Ten on Ten - Disc 3: CDPD3.iso
/
ab20
/
ab20_archive
/
utilities
/
system
/
workbench
/
tapestry.lzh
/
Tapestry.doc
< prev
next >
Wrap
Text File
|
1989-03-18
|
4KB
|
95 lines
Tapestry -- Version 2
Copyright 1989 Joe Hitchens, All Rights Reserved.
Permission is given to distribute this software and
attached data files freely, so long as the entire package
is left intact and unaltered, and no profit is made from the
transaction.
Tapestry is a little utility for attaching a pretty picture (or ugly if
you prefer) to your normal workbench display. Any 1 bitplane (2 color) IFF
picture can be loaded, though you may want to use one which has roughly the
same dimenstions and pixel aspect ratio as your Workbench screen.
Tapestry (Version 2) is only usable from the CLI. I normally have it
run as a background process from my startup-sequence. Usage is as follows:
1> tapestry picfile [ picfile2 picfile3 ... ]
or
1> run tapestry picfile [ picfile2 picfile3 ... ]
or
1> run >nil: tapestry picfile [ picfile2 picfile3 ... ]
At least one picture filename parameter is required. If more than one
picture filename is provided, Tapestry will choose one of the filenames
at random.
If the first usage is used, a ^C will exit tapestry. If the second or
third usage is used, the BREAK command can be used to exit tapestry.
If the third usage is used, and you are working under Version 1.3 of
WorkBench, the CLI can be closed after Tapestry has been 'run'.
If no usage is used, ^C or BREAK will not be necessary.
The WorkBench screen will not close when Tapestry is running. To save
memory by closing the WorkBench screen, you will have to BREAK Tapestry
first.
Possible return codes for tapestry are as follows:
0 Everything went fine. No problem.
1 Allocation of the display memory failed.
2 There was a problem loading the IFF picture file.
Either the file was not found, or not a readable IFF ILBM, or some
other such nonsense.
3 The Intuition and Graphics libraries couldn't be opened.
4 The WorkBench screen couldn't be found.
5 There is something odd about the WorkBench screen.
If the WB screen has more than 2 bitplanes (4 colors), or if
Tapestry is already running, or you already have a DUALPF, HAM
or EXTRA_HALFBRITE WorkBench (How would it be?), This will occur.
6 An attempt was made to run tapestry from an icon.
This is not supported yet.
7 Tapestry couldn't open the invisible ID window.
This is done so that calls to CloseWorkBench() will fail.
Tapestry eats up a certain amount of CHIP memory, in addition to the
program, stack and data. This is how much:
Normal non-interlace WorkBench 16K
Normal interlace WorkBench 32K
Also, if your WorkBench has overscan, even more will be consumed.
The picture files included with Tapestry and listed below were all created
by me and are "Copyright Joe Hitchens". They are, however, part of the
package as described at the top of this document.
entire package. They are:
Lyssette This is the only LARGE format picture. Use it if
you have an interlaced WorkBench.
Lyssette.200 This is a 200 line tall version for normal WorkBench's.
Lion
Rects
Window
Send comments, suggestions to me. I'll find the lovely, vivacious and
available bachelorettes myself:
Name : Joe Hitchens
Phone: (801) 292-2190
UUCP : joe@vixen.uucp
j.h.
March 18, 1989
---------------------------------------------------------------------------
Look for these features in future versions of Tapestry.
* 2 bitplane images (will use still more CHIP memory, beware)
* Repeating images. This will allow a small brush ILBM to be used and
repeated in a tile pattern to fill the entire screen.
* Icon launch.
* Animating tapestries. :-)